---
title: Migrer un projet existant vers Astro
description: Quelques trucs et astuces pour convertir votre site vers Astro.
sidebar:
  label: Vue d'ensemble de la migration de site
i18nReady: true
---
import MigrationGuidesNav from '~/components/MigrationGuidesNav.astro';

**Prêt à convertir votre site vers Astro ?** Consultez l'un de nos guides afin d'obtenir des conseils sur la migration.

## Guides de migration

<MigrationGuidesNav />

Notez que beaucoup de ces pages sont des **ébauches** : ce sont des collections de ressources qui attendent votre contribution !

## Pourquoi migrer votre site vers Astro ?

Astro offre de nombreux avantages : performance, simplicité et de nombreuses fonctionnalités que vous souhaitez sont directement intégrées dans le framework. Lorsque vous avez besoin d'étendre votre site, Astro fournit plusieurs [intégrations officielles et communautaires tierces](https://astro.build/integrations).

La migration peut s'avérer moins compliquée que vous ne le pensez !

En fonction de votre projet existant, vous pourrez peut-être réutiliser :

- vos [composants de framework UI](/fr/guides/framework-components/) directement dans Astro. 

- vos [feuilles de style ou bibliothèques CSS](/fr/guides/styling/), y compris Tailwind.

- vos [fichiers Markdown/MDX](/fr/guides/markdown-content/), configuré en utilisant vos [modules d'extension remark et rehype](/fr/guides/markdown-content/#modules-dextension-markdown) existants.

- votre [contenu depuis un CMS](/fr/guides/cms/) à travers une intégration ou une API.


## Quels projets puis-je convertir vers Astro ?

[De nombreux sites existants peuvent être créés avec Astro](/fr/concepts/why-astro/). Astro est parfaitement adapté à vos sites existants basés sur le contenu tels que les blogs, les pages d'atterrissage, les sites marketing et les portfolios. Astro s'intègre à plusieurs CMS headless populaires et vous permet de connecter des paniers de boutique e-commerce.

Astro vous permet d'avoir un site web entièrement généré de manière statique, une application dynamique avec des routes rendues à la demande ou une combinaison des deux avec [un contrôle complet sur le rendu de votre projet](/fr/guides/on-demand-rendering/), ce qui en fait un excellent remplacement pour les SSG ou pour les sites qui doivent récupérer certaines données de page à la volée.

## Comment la conception de mon projet va-t-elle changer ?

En fonction de votre projet existant, vous devrez peut-être penser différemment concernant :

- Concevoir avec les [îlots Astro](/fr/concepts/islands/#quest-ce-quun-îlot-) pour éviter d'envoyer du Javascript inutile au navigateur.

- Fournir une interactivité côté client avec les [balises `<script>` côté client](/fr/guides/client-side-scripts/) ou les [composants de framework UI](/fr/guides/framework-components/).

- Gérer [l'état partagé](/fr/recipes/sharing-state-islands/) avec Nano Stores ou le stockage local au lieu de hooks ou de wrappers à l'échelle de l'application.
